// 版权所有2009 Go作者。版权所有。
// 此源代码的使用受BSD样式
// 许可证的约束，该许可证可以在许可证文件中找到。

// go:build aix | darwin | | | | dragonfly | | | freebsd | | linux | | netbsd | | openbsd | | | solaris 
// /+build aix darwin darwin dragonfly freebsd linux netbsd openbsd solaris absd solaris 

// 从/etc resolv.conf 

package net

import (
	"internal/bytealg"
	"os"
	"sync/atomic"
	"time"
)

var (
	defaultNS   = []string{"127.0.0.1:53", "[::1]:53"}
)

type dnsConfig struct {
	search        []string      // 根后缀附加到本地名称
	ndots         int           // 名称中的点数触发绝对查找
	timeout       time.Duration // 请在放弃查询之前等待，包括重试次数
	attempts      int           // 放弃服务器前丢失的数据包
	rotate        bool          // 服务器间的循环
	unknownOpt    bool          // 遇到任何未知问题
	lookup        []string      // OpenBSD顶级数据库“查找”订单
	err           error         // 打开resolv.conf 
	mtime         time.Time     // 修改resolv.conf的时间
	soffset       uint32        // 由服务器使用Offset 
	singleRequest bool          // 使用顺序A和AAAA查询代替并行查询
	useTCP        bool          // 强制使用TCP进行DNS解析
}

// 请参阅Linux机器上的resolv.conf（5）。
func dnsReadConfig(filename string) *dnsConfig {
	conf := &dnsConfig{
		ndots:    1,
		timeout:  5 * time.Second,
		attempts: 2,
	}
	file, err := open(filename)
	if err != nil {
		conf.servers = defaultNS
		conf.search = dnsDefaultSearch()
		conf.err = err
		return conf
	}
	defer file.close()
	if fi, err := file.file.Stat(); err == nil {
		conf.mtime = fi.ModTime()
	} else {
		conf.servers = defaultNS
		conf.search = dnsDefaultSearch()
		conf.err = err
		return conf
	}
	for line, ok := file.readLine(); ok; line, ok = file.readLine() {
		if len(line) > 0 && (line[0] == ';' || line[0] == '#') {
			// 评论。
			continue
		}
		f := getFields(line)
		if len(f) < 1 {
			continue
		}
		switch f[0] {
		case "nameserver": // 添加一个名称服务器
			if len(f) > 1 && len(conf.servers) < 3 { // 较小，但标准限制
				// 再检查一次：确保服务器名称为
				// 只是一个IP地址。否则我们需要DNS 
				// 来查找它。
				if parseIPv4(f[1]) != nil {
					conf.servers = append(conf.servers, JoinHostPort(f[1], "53"))
				} else if ip, _ := parseIPv6Zone(f[1]); ip != nil {
					conf.servers = append(conf.servers, JoinHostPort(f[1], "53"))
				}
			}

		case "domain": // 设置仅此域的搜索路径
			if len(f) > 1 {
				conf.search = []string{ensureRooted(f[1])}
			}

		case "search": // 设置给定服务器的搜索路径
			conf.search = make([]string, len(f)-1)
			for i := 0; i < len(conf.search); i++ {
				conf.search[i] = ensureRooted(f[i+1])
			}

		case "options": // 魔术选项
			for _, s := range f[1:] {
				switch {
				case hasPrefix(s, "ndots:"):
					n, _, _ := dtoi(s[6:])
					if n < 0 {
						n = 0
					} else if n > 15 {
						n = 15
					}
					conf.ndots = n
				case hasPrefix(s, "timeout:"):
					n, _, _ := dtoi(s[8:])
					if n < 1 {
						n = 1
					}
					conf.timeout = time.Duration(n) * time.Second
				case hasPrefix(s, "attempts:"):
					n, _, _ := dtoi(s[9:])
					if n < 1 {
						n = 1
					}
					conf.attempts = n
				case s == "rotate":
					conf.rotate = true
				case s == "single-request" || s == "single-request-reopen":
					// Linux选项：
					// http:
					// ”默认情况下，glibc并行执行IPv4和IPv6查找[…]
					// 此选项禁用该行为并使glibc 
					// 按顺序执行IPv6和IPv4请求。“
					conf.singleRequest = true
				case s == "use-vc" || s == "usevc" || s == "tcp":
					// Linux（使用vc）、FreeBSD（使用vc）和OpenBSD（tcp）选项：
					// http:
					// “在_RES.options中设置RES_USEVC。
					// 此选项强制使用TCP进行DNS解析。“
					// https:
					// https:
					conf.useTCP = true
				default:
					conf.unknownOpt = true
				}
			}

		case "lookup":
			// OpenBSD选项：
			// https:
			// ”合法空格分隔值为：bind、file、yp“
			conf.lookup = f[1:]

		default:
			conf.unknownOpt = true
		}
	}
	if len(conf.servers) == 0 {
		conf.servers = defaultNS
	}
	if len(conf.search) == 0 {
		conf.search = dnsDefaultSearch()
	}
	return conf
}

// serverOffset返回一个偏移量，该偏移量可用于在进行查询时确定c.servers中服务器的索引。
// 启用旋转选项时，此偏移量增加。
// 否则始终为0。
func (c *dnsConfig) serverOffset() uint32 {
	if c.rotate {
		return atomic.AddUint32(&c.soffset, 1) - 1 // 返回0以启动
	}
	return 0
}

func dnsDefaultSearch() []string {
	hn, err := getHostname()
	if err != nil {
		// 尽最大努力
		return nil
	}
	if i := bytealg.IndexByteString(hn, '.'); i >= 0 && i < len(hn)-1 {
		return []string{ensureRooted(hn[i+1:])}
	}
	return nil
}

func hasPrefix(s, prefix string) bool {
	return len(s) >= len(prefix) && s[:len(prefix)] == prefix
}

func ensureRooted(s string) string {
	if len(s) > 0 && s[len(s)-1] == '.' {
		return s
	}
	return s + "."
}
